package com.sky.controller.admin;

import com.sky.dto.CategoryDTO;
import com.sky.dto.CategoryPageQueryDTO;
import com.sky.entity.Category;
import com.sky.result.PageResult;
import com.sky.result.Result;
import com.sky.service.CategoryService;
import io.swagger.annotations.Api;
import io.swagger.annotations.ApiOperation;
import lombok.extern.slf4j.Slf4j;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.*;

import java.util.List;

/*
 * 分类管理的Controller
 * Controller的作用：接收前端发送请求传递过来的参数并且进行封装以及调用service层的方法进行查询数据库处理逻辑并且封装结果响应给前端请求
 */
/* @Slf4j是用作日志输出的，一般会在项目每个类的开头加入该注解并且使用log.info() */
@Slf4j
/*
 *@RestController 是一个组合注解，它结合了 @Controller 和 @ResponseBody 注解的功能（就相当于把两个注解组合在一起）
 *在使用 @RestController 注解标记的类中，每个方法的返回值都会以 JSON 或 XML 的形式直接写入 HTTP 响应体中，相当于在每个方法上都添加了 @ResponseBody 注解
 * */
@RestController
/*
 * @RequestMapping表示共享映射，如果没有指定请求方式，将接收GET、POST、HEAD、OPTIONS、PUT、PATCH、DELETE、TRACE、CONNECT所有的HTTP请求方式
 * @RequestMapping 注解可以在控制器类上和控制器类中的方法上使用。
 * @GetMapping、@PostMapping、@PutMapping、@DeleteMapping、@PatchMapping 都是HTTP方法特有的快捷方式@RequestMapping的变体，分别对应具体的HTTP请求方式的映射注解
 * */
@RequestMapping("/admin/category")
@Api(tags = "分类管理相关的接口")

public class CategoryController {
    /* @Autowired进行自动依赖注入，对类、成员变量、成员方法及构造方法进行标注，完成bean自动装配的工作*/
    @Autowired
    private CategoryService categoryService;

    /**
     * 查询所有分类
     *
     * @param categoryPageQueryDTO
     * @return Result<PageResult>
     * @info 接收前端传递过来的分页参数(路径参数)，调用Service层的方法并且传递前端分页路径参数给Service层 Controller->Service->Mapper
     */
    @GetMapping("/page")
    @ApiOperation("查询所有分类")
    public Result<PageResult> fetchCategoryList(CategoryPageQueryDTO categoryPageQueryDTO) {
        PageResult pageResult = categoryService.fetchCategoryList(categoryPageQueryDTO);
        return Result.success(pageResult);
    }

    /**
     * 添加分类
     *
     * @param categoryDTO
     * @return void
     * @info 接收前端传递过来的套餐分类或者菜品分类，调用Service层的方法并且传递套餐或者菜品分类给Service层 Controller->Service->Mapper
     */

    @PostMapping("")
    @ApiOperation("新增分类")
    public Result addCategory(@RequestBody CategoryDTO categoryDTO) {
        categoryService.addCategory(categoryDTO);
        return Result.success();
    }


    /**
     * 删除分类
     *
     * @param id
     * @return void
     * @info 接收前端传递过来的分类ID，调用Service层的方法并且传递ID给Service层 Controller->Service->Mapper
     */
    @DeleteMapping("")
    @ApiOperation("删除分类")
    public Result deleteCategoryById(@RequestParam Long id) {
        categoryService.deleteCategoryById(id);
        return Result.success();
    }

    /**
     * 修改分类
     *
     * @param categoryDTO
     * @return void
     * @info 接收前端传递过来的分类，调用Service层的方法并且传递修改后的分类给Service层 Controller->Service->Mapper
     */
    @PutMapping("")
    @ApiOperation("修改分类")
    public Result updateCategory(@RequestBody CategoryDTO categoryDTO) {
        categoryService.updateCategory(categoryDTO);
        return Result.success();
    }

    /**
     * 启用或者禁用分类
     *
     * @param status
     * @param id
     * @return void
     * @info 接收前端传递过来的分类ID以及分类状态，调用Service层的方法并且传递ID和status给Service层 Controller->Service->Mapper
     */
    @PostMapping("/status/{status}")
    @ApiOperation("启用或者禁用分类")
    public Result openOrCloseCategory(@PathVariable Integer status, @RequestParam Long id) {
        categoryService.openOrCloseCategory(status, id);
        return Result.success();
    }

    /**
     * 根据分类的类型type查询分类
     *
     * @param type
     * @return category
     * @info 接收前端传递过来的type，1为菜品分类、2为套餐分类，调用Service层的方法并且传递type给Service层 Controller->Service->Mapper
     */

    @GetMapping("/list")
    @ApiOperation("根据分类的类型type查询分类")
    public Result<List<Category>> fetchCategoryByType(@RequestParam Integer type) {
        List<Category> categoryList = categoryService.fetchCategoryByType(type);
        return Result.success(categoryList);
    }
}
